home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Belgian Amiga Club - ADF Collection
/
BS1 part 60.zip
/
BS1 part 60
/
Imagemaster d4.adf
/
apa.lzh
/
hlp_arexx8
< prev
next >
Wrap
Text File
|
1993-08-30
|
18KB
|
778 lines
\ApAssist
\: - This is the Quick Help for the ARexx in IM R/t -
\: ----------------------------------------------------------
\: Written by David E. Patterson
\: ----------------------------------------------------------
\font topaz.font 8
\tc 1
\wr
\lj
\dd "imh_descriptor"
\index "hlp_arexx2/gamma-listreq"
\toc "hlp_toc/toc"
\help "aa_help/help
\node "iptofront"
\title "IP to Front"
\next "jackin"
\prev ""
\{ \tc 15 Iptofront \} - Brings the IP screens to the front.
When used as the last command in a script the main panel is activated, just
as if the user clicked in it.
\nw
Usage - '\{ \tc 15 iptofront\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 iptofront\} ';
\endnode
\node "jackin"
\title "Jackin"
\next "killbuff"
\prev "iptofront"
\{ \tc 15 Jackin \} - Returns a single pointer in hexadecimal format.
\{ \tc 15 Jackin \} returns a hexadecimal pointer, which points to the base
of another group of pointers, each of which points to buffer information.
\nw
Usage - '\{ \tc 15 jackin\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 jackin\} ';
jackptr = result;
options;
'backuptoundo';
address command;
'cmpi:myfile '||jackptr;
address(prtnme);
'redraw';
\endnode
\node "killbuff"
\title "Kill Buffer"
\next "lineart"
\prev "jackin"
\{ \tc 15 Killbuff \} - Deletes a buffer.
\nw
Usage - '\{ \tc 15 killbuff <number>\} '
\{ \ts bu Sample Script\} :
options results;
'current';
info = result;
options;
parse var info bname','bnumber','xdim','ydim','xdimydim','memused','
parentname','parentnumber;
'\{ \tc 15 killbuff\} ' bnumber;
\endnode
\node "lineart"
\title "Line Art"
\next "lined"
\prev "killbuff"
\{ \tc 15 Lineart \} - Creates line art from a selected area.
\nw
Usage - '\{ \tc 15 lineart <effect> <threshold> <monochrome>
<blackline>\} '
\{ \tc 15 Effect: 0 - 100%
Threshold: 0 - 255
Monochorome: 0 = No, 1 = Yes
Blackline: 0 = No, 1 = Yes \}
\{ \ts bu Sample Script\} :
'area';
options results;
'askprop Effect: 50 0 100';
effect = result;
'askprop Threshold: 127 0 255';
threshold = result;
'askyn "No Monochrome" "Monochrome"';
mono = result;
'askyn "White Line" "Black Line"';
line = result;
options;
'\{ \tc 15 lineart\} ' effect threshold mono line;
\endnode
\node "lined"
\title "Lined"
\next "listreq"
\prev "lineart"
\{ \tc 15 Lined \} - Converts image brightness to image thickness.
\nw
Usage - '\{ \tc 15 lined <len>\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 lined 2\} ';
* User Interface: \{ \tc 11 Process Panel
Special Effects
Lined\}
\endnode
\node "listreq"
\title "List Request"
\next "load"
\prev "lined"
\{ \tc 15 Listreq \} - Calls a list requester.
Calls a list requester from which the user can select an entry. The selected
item returns a string to the calling ARexx script or .
\nw
Usage - '\{ \tc 15 listreq "Title text",listfile,"keywords,etc"\} '
\{ \ts bu Sample Script\} :
(Fragment)
options results;
'\{ \tc 15 listreq "Launch a P.I. Module","work:mylist.list","load\} ';
name = result;
options;
if name = '' then
do
exit 0;
end;
\endnode
\node "load"
\title "Load"
\next "loadasblend"
\prev "listreq"
\{ \tc 15 Load \} - Loads an image.
Uses the current image path and extension and to load an image.
\nw
Usage - '\{ \tc 15 load <filename>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "Buffername:" "myfile"'name;
name = result;
options;
'\{ \tc 15 load\} ' name;
See Also: \{ \tc 15 \ts b \link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary" "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadasblend"
\title "Load as Blend"
\next "loadasbrush"
\prev "load"
\{ \tc 15 Loadasblend \} - Loads a blend
Loads an image file and makes it the blend (alpha) buffer. Uses the current
image path and extension.
\nw
Usage - '\{ \tc 15 loadasblend <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
options;
'\{ \tc 15 loadasblend\} ' name;
See Also: \{ \tc 15 \ts b \link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary" "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadasbrush"
\title "Load as a Brush"
\next "loadasprimary"
\prev "loadasblend"
\{ \tc 15 Loadasbrush \} - Loads a brush.
Loads an image file and makes it the brush buffer. Uses the current image
path and extension.
\nw
Usage - '\{ \tc 15 loadasbrush <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
options;
'\{ \tc 15 loadasbrush\} ' name;
See Also: \{ \tc 15 \ts b \link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary" "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadasprimary"
\title "Load as a Primary Buffer"
\next "loadassecondary"
\prev "loadasbrush"
\{ \tc 15 Loadasprimary \} - Loads an image file and makes it the primary.
\nw
Usage - '\{ \tc 15 loadasprimary <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
'\{ \tc 15 loadasprimary\} ' name;
options;
See Also: \{ \ts b \tc 15 \link "loadassecondary " "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadassecondary"
\title "Load as a Secondary Buffer"
\next "loadimask"
\prev "loadasprimary"
\{ \tc 15 Loadassecondary \} - Loads an image file and makes it the secondary
buffer.
\nw
Usage - '\{ \tc 15 loadassecondary <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
options;
'\{ \tc 15 loadassecondary\} ' name;
See Also: \{ \tc 15 \ts b \link "loadasprimary" "hlp_arexx8/loadasprimary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask" \}
\endnode
\node "loadimask"
\title "Load Image Mask"
\next "loadmask"
\prev "loadassecondary"
\{ \tc 15 Loadimask \} - Loads the valid image area mask from a saved mask
file.
\nw
Usage - '\{ \tc 15 loadimask <path&filename> [mode]\} '
\{ \tc 15 Mode 1 = Replace existing mask (default)
2 = OR
3 = AND
4 = XOR
5 = MINUS\}
\{ \ts bu Sample Script\} :
'\{ \tc 15 loadimask work:images/image.iff\} ';
\endnode
\node "loadmask"
\title "Load Mask"
\next "loadpal"
\prev "loadimask"
Loadmask - Loads a mask
\nw
Usage - '\{ \tc 15 loadmask <complete_filename> [mode]\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 loadmask work:images/mymask.msk \} ';
\{ \tc 15 Mode 1 = Replace existing mask (default)
2 = OR
3 = AND
4 = XOR
5 = MINUS\}
* User Interface: \{ \tc 11 File I/O
Load Mask\}
\endnode
\node "loadpal"
\title "Load Palette"
\next "lockimage"
\prev "loadmask"
\{ \tc 15 Loadpal \} - Loads a previously saved palette.
\nw
Usage - '\{ \tc 15 loadpal <palettename>\} ';
\{ \ts bu Sample Script\} :
'paletteext pa8';
'palettepath work:images';
'\{ \tc 15 loadpal palfile\} ';
'area';
'mappal';
* User Interface: \{ \tc 11 Paint Panel
Adjust Palette
LD Palette\}
\endnode
\node "lockimage"
\title "Lock Image"
\next "lockprimary"
\prev "loadpal"
\{ \tc 15 Lockimage \} - Locks a buffer.
\nw
Usage - '\{ \tc 15 lockimage <buffer number>\} '
\{ \ts bu Sample Script\} :
options results;
'secondary';
buffs = result;
parse var buffs name","number","remainder;
'\{ \tc 15 lockimage\} ' number;
options;
\endnode
\node "lockprimary"
\title "Lock Primary"
\next "locksecondary"
\prev "lockimage"
\{ \tc 15 Lockprimary \} - Locks Primary Buffer.
\nw
Usage - '\{ \tc 15 lockprimary\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 lockprimary\} ';
\endnode
\node "locksecondary"
\title "Lock Secondary"
\next "lowpass"
\prev "lockprimary"
\{ \tc 15 Locksecondary \} - Locks the secondary buffer.
\nw
Usage - '\{ \tc 15 locksecondary\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 locksecondary\} ';
\endnode
\node "lowpass"
\title "Low Pass Filter"
\next "luma"
\prev "locksecondary"
\{ \tc 15 Lowpass \} - The equivalent of an electronic low-pass filter.
\nw
Usage - '\{ \tc 15 lowpass <effect> <direction>\} '
\{ \tc 15 Effect: 0 - 100%
Direction: 1 = horizontal, 2 = vertical, 3 = both\}
\{ \ts bu Sample Script\} :
'area';
options results;
askprop effect 50 0 100;
effect = result;
options;
'\{ \tc 15 lowpass\} 'result;
options results;
'gadgets "Filter","Vertical "Filter" "Horizontal" "Filter","Horizontal and
Vertical"';
direction = result;
options;
'\{ \tc 15 lowpass\} ' effect direction;
See Also: \{ \tc 15 \ts b \link "highpass" "hlp_arexx7/highpass" \}
\endnode
\node "luma"
\title "Luma"
\next "macrodefs"
\prev "lowpass"
\{ \tc 15 Luma \} - Changes the region to luma equivalent B&W.
\nw
Usage - '\{ \tc 15 luma\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 luma\} ';
See Also: \{ \tc 15 \ts b \link "negluma" "hlp_arexx9/negluma"\}
* User Interface: \{ \tc 11 Process Panel
Special Effects
Luma\}
\endnode
\node "macrodefs"
\title "Macro Definitions"
\next "macroext"
\prev "luma"
\{ \tc 15 Macrodefs \} - Returns path and extension of a saved macros.
\nw
Usage - '\{ \tc 15 macrodefs\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 macrodefs\} '
info = result;
parse var info path ','extension;
options;
See also: \{ \tc 15 \ts b \link "blenddefs " "hlp_arexx5/blenddefs"
\link "imagedefs " "hlp_arexx7/imagedefs"
\link "palettedefs" "hlp_arexx9/palettedefs"
\link "renderdefs " "hlp_arexx10/renderdefs"\}
\endnode
\node "macroext"
\title "Macro Extension"
\next "macroload"
\prev "macrodefs"
\{ \tc 15 Macroext \} - Sets a new extension for saving and loading macros
files.
\nw
Usage - '\{ \tc 15 macroext <newext>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "New Extension:" "mac"'name;
name = result;
options;
'\{ \tc 15 macroext\} ' name;
See Also: \{ \tc 15 \ts b \link "blendext " "hlp_arexx5/blendext"
\link "imageext " "hlp_arexx7/imageext"
\link "paletteext" "hlp_arexx9/paletteext"
\link "renderext " "hlp_arexx10/renderext"\}
* User Interface: \{ \tc 11 Setup Panel
Macro Ext \}
\endnode
\node "macroload"
\title "Macro Load"
\next "macropath"
\prev "macroext"
\{ \tc 15 Macroload \} - Loads a Macro file.
\nw
Usage - '\{ \tc 15 macroload <filename>\} ' (without path)
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "macrofile"'name;
name = result;
options;
'\{ \tc 15 macroload\} ' name;
See Also: \{ \tc 15 \ts b \link "blendload " "hlp_arexx5/blendload"
\link "loadasblend " "hlp_arexx8/loadasblend"
\link "loadasbrush " "hlp_arexx8/loadasbrush"
\link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary " "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
* User Interface: \{ \tc 11 Macro Panel
Load Macro Set\}
\endnode
\node "macropath"
\title "Macro Path"
\next "mappal"
\prev "macroload"
\{ \tc 15 Macropath \} - Sets the path for loading and saving Macros.
\nw
Usage - '\{ \tc 15 macropath <newpath>\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 macropath work:macros\} ';
See Also: \{ \tc 15 \ts b \link "blendpath " "hlp_arexx5/blendpath"
\link "imagepath " "hlp_arexx7/imagepath"
\link "palettepath" "hlp_arexx9/palettepath"
\link "renderpath " "hlp_arexx10/renderpath" \}
* User Interface: \{ \tc 11 Setup Panel
Macro Path\}
\endnode
\node "mappal"
\title "Map Palette"
\next "maxmerge"
\prev "macropath"
\{ \tc 15 Mappal \} - Causes selected region to be mapped to the current
palette.
\nw
Usage - '\{ \tc 15 mappal\} '
\{ \ts bu Sample Script\} :
'loadpal palfile';
'area';
'\{ \tc 15 mappal\} ';
* User Interface: \{ \tc 11 Process Panel
Special Effects
Map to Palette\}
\endnode
\node "maxmerge"
\title "Maximum Merge"
\next "maxrub"
\prev "mappal"
\{ \tc 15 Maxmerge \} - Merges where secondary buffer is darker than the
primary buffer.
Merges the secondary buffer into the primary buffer where the color of the
secondary buffer is darker than that in the primary buffer.
\nw
Usage - '\{ \tc 15 maxmerge\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 maxmerge\} ';
See Also: \{ \tc 15 \ts b \link "minmerge" "hlp_arexx8/minmerge" \}
* User Interface: \{ \tc 11 Compose Panel
Linear Compositions
Maximum Merge\}
\endnode
\node "maxrub"
\title "Maximum Rub Through"
\next "melt"
\prev "maxmerge"
\{ \tc 15 Maxrub \} - Rubs through to primary buffer if the secondary buffer
is darker.
Rubs the secondary buffer through the primar buffer where the color of the
secondary buffer is brighter than the primary buffer.
\nw
Usage - '\{ \tc 15 maxrub\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 maxrub\} ';
See Also: \{ \tc 15 \ts b \link "minrub" "hlp_arexx8/minrub"\}
* User Interface: \{ \tc 11 Compose Panel
Linear Compositions
Maximum Merge\}
\endnode
\node "melt"
\title "Melt"
\next "merge"
\prev "maxrub"
\{ \tc 15 Melt \} - Causes a selected region to appear to be melting.
\nw
Usage - '\{ \tc 15 melt\} '
\{ \ts bu Sample Script\} :
'area';
'melt';
* User Interface: \{ \tc 11 Process Panel
Special Effects
Melt\}
\endnode
\node "merge"
\title "Merge"
\next "message"
\prev "melt"
\{ \tc 15 Merge \} - Merges the secondary buffer into the primary buffer.
\nw
Usage - '\{ \tc 15 merge\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 merge\} ';
See Also: \{ \tc 15 \ts b \link "maxmerge " "hlp_arexx8/maxmerge"
\link "minmerge " "minmerge"\}
* User Interface: \{ \tc 11 Compose Panel
Linear Compositions
Merge\}
\endnode
\node "message"
\title "Message"
\next "minmerge"
\prev "merge"
\{ \tc 15 Message \} - Presents the user with a message.
Halts script presenting user with a message, when the user clicks on the
message gadget the script resumes.
\nw
Usage - '\{ \tc 15 message <textstring>\} '
\{ \ts bu Sample Script\} :
if flag = 3 then do
'\{ \tc 15 message Warning there is no Secondary Buffer\} ';
exit 0;
End;
\endnode
\node "minmerge"
\title "Minmerge"
\next "minrub"
\prev "message"
\{ \tc 15 Minmerge \} - Merges where the secondary buffer is brighter than
the primary buffer.
Merges the secondary buffer into the primary buffer where the color of the
secondary buffer is darker than the primary buffer.
\nw
Usage - '\{ \tc 15 minmerge\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 minmerge\} ';
* User Interface: \{ \tc 11 Compose Panel
Linear Compositions
Minimum Merge\}
\endnode
\node "minrub"
\title "Minimum Rub Through"
\next "mirror"
\prev "minmerge"
\{ \tc 15 Minrub \} - Rubs through if the secondary buffer is brighter than
the primary buffer.
Rubs the secondary buffer through to the primary buffer where the color of
the secondary buffer is brighter than the primary buffer.
\nw
Usage - '\{ \tc 15 minrub\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 minrub\} ';
See Also: \{ \tc 15 \ts b \link "maxrub" "hlp_arexx8/maxrub"\}
* User Interface: \{ \tc 11 Compose Panel
Linear Compositions
Minimum Rub-Thru\}
\endnode
\node "mirror"
\title "Mirror"
\next ""
\prev "minrub"
\{ \tc 15 Mirror \} - Creates mirror images of a selected area.
\nw
Usage - '\{ \tc 15 mirror <direction> <keephor> <keepvert>\} '
\{ \tc 15 Direction: 1 = up, 2 = down, 3 = both
Keep Horizontal: 0 = right, 1 = left;
Keep Veritcal: 0 = up, 1 = down\}
\{ \ts bu Sample Script\} :
'\{ \tc 15 mirror 1 0 1\} ';
* User Interface: \{ \tc 11 Process Panel
Geometric Transformations
Mirror\}
\endnode